노선

개요

인게임에서 역과 역을 이어주는 역할을 합니다.

기능

노선은 터치, 클릭으로 생성, 연장, 취소할 수 있습니다.

자세한 내용은 Document : 인게임 에서 확인할 수 있습니다.

개발

노선은 LaneManager와 Lane 클래스에 구현되어 있습니다. LaneManager 생성은 TinyMetroGameModeBase 에서 담당합니다.

생성

역을 하나 클릭/터치할 때마다 AddSelectedStations로 SelectedStations 배열에 역을 추가합니다.

IsPlacementValid 변수로 노선 연장/축소 와 생성을 구분합니다.

IsPlacementValid 이 false면 노선 생성으로 SelectedStations에 역이 2개가 되면 CreatingNewLane함수를 불러 새로운 노선을 생성하고, SelectedStations를 초기화합니다.

새로 생긴 노선에는 열차 아이템이 있으면 Lane의 SpawnTrain함수로 열차를 하나 스폰합니다.

연장 / 축소

노선의 양쪽 핸들을 클릭/터치하면 이벤트로 LaneManager의 IsPlacementValid 변수를 true로 만듭니다.

그리고 Is Start/End Handle Editing 변수를 true로 만듭니다.

이 상태에서 SelectedStations에 역이 추가되면 해당 Lane의 ExtendLane함수를 불러오고, SelectedStations를 초기화합니다.

ExtendLane에서는 IsPlacementValid와 Is Handle Editing 변수로 AddStationStart와 AddStationEnd 둘 중 하나의 함수를 불러 연장/축소를 판별합니다.

다음은 AddStationStart/End 가 선택한 역에 따라 노선의 연장 축소를 판별하는 방식입니다.

   1. 먼저 노선의 개수가 2개인지 확인합니다.

      1-1. 2개면 선택한 역이 클릭한 노선 내에서 핸들의 반대편 끝에 해당하는지 확인합니다.

          1-1-1. 해당하면 노선을 삭제합니다.

          1-1-2. 해당하지 않으면 노선을 연장합니다.

      1-2. 2개가 아니면 2번으로 진행합니다.

   2. 다음에는 이 노선이 순환선인지 파악합니다.

      2-1. 순환선이면 선택한 역이 노선 내에서 핸들의 2번째로 인접한 역인지 확인합니다.

          2-1-1. 맞다면 순환선을 해제합니다.

      2-2. 순환선이 아니면 3번으로 진행합니다.

   3. 선택한 역이 클릭한 노선 내에서 핸들의 반대편 끝에 해당하는지 확인합니다.

      3-1. 맞다면 순환선으로 만듭니다.

      3-2. 아니라면 4번으로 진행합니다.

   4. 노선 내에 선택한 역이 있는지 확인합니다.

      4-1. 맞다면 해당 역까지 노선을 축소합니다.

      4-2. 아니라면 5번으로 진행합니다.

   5. 노선을 연장합니다.

이러한 큰 줄기에 몇 가지 조건이 더 붙습니다.

노선을 연장할 때 다리/터널 아이템 개수를 확인하고, 삭제될 노선에 열차가 있다면 지연 삭제를 예약합니다.

노선 내부에서 연장/축소 작업을 한 뒤에는 눈에 보이는 부분을 연장/축소 시킵니다.

그리고 핸들도 바뀐 노선에 맞게 조정합니다.

경로 계산(TODO)

노선 스플라인 구현(TODO)

다리/터널 아이템 개수 확인(TODO)

지연 삭제

노선 축소/삭제를 할 때 열차가 그 구간을 지나갈 때 바로 삭제된다면 문제가 발생합니다.

그래서 위의 경우 해당 구간을 삭제될 구간으로 만들고 열차가 지나가면 처리합니다.

역을 저장하는 StatonPoint 배열에서는 즉시 역을 지우고, 지우기 전 값을 따로 StationPointBeforeRemoved에 저장합니다.

그리고 지워질 역들을 StationsToBeRemoved 배열로 저장합니다.

삭제될 구간을 지나가는 열차들에겐 TrainManager의 NotifyTrainsOfRemoving 함수로 알립니다.

Lane의 Tick함수에서 FinishRemovingLane/ FinishClearing 함수를 불러 열차를 확인한 후, 없다면 축소/삭제를 진행합니다.

노선 모양 변경

노선을 더블 클릭하면 해당 구간은 반대로 노선 모양이 변경됩니다.

LaneArray에 있는 SplineMeshComponent에 각각 AddDynamic으로 터치, 클릭 이벤트를 추가합니다.

CheckDoubleTap, CheckDoubleClick으로 더블 클릭을 판별하고 맞다면 DoubleTapEvent 함수로 넘어가 이벤트가 일어난 메시가 있는 구간을 받습니다.

구간 양 끝에 해당하는 Station을 GetConnectedStations 함수로 찾고, 이를 CheckIsChangableLaneAppearance 함수로 넘깁니다.

이 함수에서는 모양 변경이 가능한지 파악하기 위해 BridgeTunnel 아이템의 개수, 양 끝 역을 목적지로 갖는 열차의 개수를 확인합니다.

먼저 현재 경로로의 FLanePoint들을 찾아 배치된 BridgeTunnel 아이템의 개수와 보유하고 있는 아이템 개수를 더한 값과,

새로 만들어질 경로의 FLanePoint들에 배치될 BridgeTunnel 아이템의 개수를 비교합니다.

여기서 가능하다면 열차의 개수를 확인하고 열차가 없다면 DisConnectBT를 한 뒤, ChangeLaneAppearance 함수로, 있으면 지연 변경을 진행합니다.

지연 변경은 앞서 설명한 지연 삭제와 작동 방식이 같습니다.

ChangeLaneAppearance는 새로운 경로를 LaneArray에 덮어쓰고, Spline을 만들어 새로운 메시를 연결합니다.

그리고 필요한 BridgeTunnel Item을 ConnectBT로 추가합니다.

LaneManager

Property
- TMap<int32, ALane*> Lanes;
  - Lane 포인터를 저장한 배열입니다.
- bool IsPlacementValid;
  - True면 노선의 핸들을 선택한 상태입니다.
- FLaneSelectDelegate LaneSelectDelegate;
  - Lane을 선택했을 때 실행됩니다.
- FLaneCancelDelegate LaneCancelDelegate;
  - Lane 선택을 취소했을 때 실행됩니다.
- UClass* LaneClass = nullptr;
- bool CanAssignBridge;
- bool CanAssignTunnel;
- TArray NextLaneNums = {1,2,3,4,5,6,7,8};
  - 새로 생성될 Lane의 Id 리스트입니다.
- TArray<UMaterial*> LaneMaterial;
- TArray LaneMaterialPath;
- int32 SelectedLaneNum;
  - 현재 선택된 Lane의 Id입니다.
- int32 UILaneNum;
  - UI에 표시될 Lane의 Id입니다.
- TArray<class AStation*> SelectedStations;
  - 현재 선택된 역의 포인터를 담은 배열입니다.
Function
- int32 GetLaneCount() const;
  - Lane 개수를 받습니다.
- int32 GetRandomLaneId() const;
- void SetCanAssginBridge(bool AssginBridge);
- void SetCanAssginTunnel(bool AssginTunnel);
- void AddNextLaneNums(int32 LaneNum);
  - NextLaneNums에 LaneNum을 추가하고 정렬합니다.
- void RemoveNextLaneNums();
  - NextLaneNums의 첫 요소를 지웁니다.
- void RemoveDestroyedLane(int LaneNum);
- void SetUILaneNum(int32 Num);
  - UILaneNum을 설정합니다.
- int32 GetUILaneNum();
  - UILaneNum을 받습니다.
- void SetSelectedLaneNum(int32 Num);
  - SelectedLaneNum을 받고 UILaneNum을 설정합니다.
- void AddSelectedStations(class AStation* Station);
  - SelectedStations에 Station을 추가하고 조건에 따라 노선 생성, 연장, 축소 등을 결정합니다.
- void CancelSelectedStations();
  - SelectedStations를 비웁니다.
- class ALane* SpawnLane();
  - Lane 스폰함수입니다.
- void CreatingNewLane();
  - 새로운 노선을 만드는 함수입니다.
- ALane* GetLaneById(int32 LaneId);
  - LaneId로 Lane 포인터를 반환합니다.
- void InitLaneMaterial();
- void LaneMaterialDeferred();
- TArray<UMaterial*> GetLaneMaterial() const;
- int32 GetPosition(FIntPoint Start, FIntPoint End);
- void Save();
  - LaneManager와 Lane의 정보를 저장합니다.
- bool Load();
  - LaneManagerSaveGame으로부터 저장된 정보를 받아 정보를 넣습니다.
- class ALane* LoadLane(int32 LaneId);
  - 각 Lane의 Load 함수를 호출합니다.
- void CheckTransferStation();
  - 환승역을 집계해 Statistics에 저장합니다.

Lane 함수

PopHandle
- Property
  - static FOnPopHandleCalled OnPopHandleCalled;
  - bool CurrentlyPoppingLane;
- Function
  - virtual void PopHandle(bool isUp) override;
  - void OnOtherLanePopHandleCalled(bool isUp);
Lane Information
- Property
  - int32 LaneId;
    - 노선의 번호입니다.
  - bool IsCircularLine;
    - 순환선 여부를 저장합니다.
  - TArray<class AStation*> StationPoint;
    - 노선이 가진 역의 배열입니다.
  - TArray LaneArray;
    - 노선이 가진 그리드 상의 지점입니다.
- Function
  - int32 GetLaneId();
    - 노선 번호를 반환합니다.
  - void SetLaneId(int _LaneId);
    - 노선 번호를 설정합니다.
  - bool GetIsCircularLine();
    - 순환선 여부를 반환합니다.
  - void SetIsCircularLine(bool _Circular);
    - 순환선 여부를 설정합니다.
Delay Removing
- Property
  - TArray <AStation*> StationsToBeRemovedAtEnd;
    - 노선의 끝 부분에서 삭제될 역입니다.
  - TArray <AStation*> StationsToBeRemovedAtStart;
    - 노선의 시작 부분에서 삭제될 역입니다.
  - TArray <AStation*> StationPointBeforeRemovedEnd;
    - 노선 끝 부분에서 삭제되기 전 StationPoint입니다.
  - TArray <AStation*> StationPointBeforeRemovedStart;
    - 노선 시작 부분에서 삭제되기 전 StationPoint입니다.
  - bool DoesStationsToBeRemovedAtStart;
    - 노선 시작 부분에서 삭제가 예약되었는지 확인합니다.
  - bool DoesStationsToBeRemovedAtEnd;
    - 노선 끝 부분에서 삭제가 예약되었는지 확인합니다.
  - bool DoesLaneToBeRemoved;
    - 노선 전체 삭제가 예약되었는지 확인합니다.
- Function
  - void FinishRemovingLaneAtStart();
  - virtual void FinishRemovingLaneAtStart_Implementation();
    - 삭제될 역을 향하는 열차의 개수를 검사해 시작 부분의 삭제를 진행합니다.
  - void FinishRemovingLaneAtEnd();
  - virtual void FinishRemovingLaneAtEnd_Implementation();
    - 삭제될 역을 향하는 열차의 개수를 검사해 시작 부분의 삭제를 진행합니다.
  - void FinishClearingLane();
  - virtual void FinishClearingLane_Implementation();
    - 노선의 열차를 검사해 노선 전체 삭제를 진행합니다.
  - bool CheckTrainsByDestination(const TArray <class AStation*>& Stations);
    - 목적지와 출발지로 해당 역을 받는 열차가 있는지 확인합니다.
  - void NotifyTrainsOfRemoving(const TArray <class AStation*>& Stations);
    - 사라질 구간의 열차에 삭제 알림을 보냅니다.
  - void ModifyStationInfoWhenRemoving(const TArray <class AStation*>& Stations);
    - 삭제되는 구간의 역을 비활성화하고 역에 저장된 노선을 삭제합니다.
  - TArray<class AStation*> CollectEveryStations();
    - 삭제될 역을 모두 모읍니다.
  - void MarkLaneToRemoveFromStart(int32 Index);
    - 삭제될 노선의 시작 부분을 표시합니다.
  - void MarkLaneToRemoveFromEnd(int32 Index,int32 ExStationNum);
    - 삭제될 노선의 끝 부분을 표시합니다.
  - void MarkLaneToClear();
    - 전체 노선의 삭제를 표시합니다.
Train Related
- Function
  - FIntPoint GetNextLocation(class ATrainTemplate* Train, FIntPoint CurLocation, TrainDirection Direction);
    - 해당 열차의 다음 목적지를 반환합니다.
  - TrainDirection SetDirectionInit(class AStation* Station, FIntPoint CurLocation) const;
    - 목표역과 현재 위치로 열차의 상행, 하행을 결정합니다.
  - void SpawnTrain();
    - 새로 생성된 노선 위에 열차를 생성합니다.
  - AStation* GetNextStation(AStation* CurrStation, TrainDirection Direction);
    - 열차의 진행 방향을 이용해 다음 역을 반환합니다.
Change Appearance
- Property
  - int32 PressedCount;
    - 더블 클릭을 판단하는 클릭 횟수입니다.
- Function
  - void ChangeLaneAppearance(TArray AddLaneArray, int32 StartIndex, int32 EndIndex);
    - 일정 구간의 노선 모양을 바꿉니다.
  - void DoubleTapEvent(USplineMeshComponent* ClickedMesh);
    - 더블 클릭 / 터치 이벤트가 일어나면 실행되는 함수입니다.
  - void CheckIsChangableLaneAppearance(TArray<AStation*> TargetStations);
    - 노선 모양을 변경할 수 있을지 확인합니다.
  - void CheckDoubleTap(ETouchIndex::Type FingerIndex, UPrimitiveComponent* TouchedComponent);
    - 더블 터치인지 확인합니다.
  - void CheckDoubleClick(UPrimitiveComponent* TouchedComponent, FKey ButtonPressed);
    - 더블 클릭인지 확인합니다.
  - void InitPressedCountDelay(ETouchIndex::Type FingerIndex, UPrimitiveComponent* TouchedComponent);
    - 더블 터치 판단에 사용되는 이벤트입니다.
  - void InitPressedCountDelayWithClick(UPrimitiveComponent* TouchedComponent, FKey ButtonReleased);
    - 더블 클릭 판단에 사용되는 이벤트입니다.
  - TArray<AStation*> GetConnectedStations(USplineMeshComponent* ClickedMesh);
    - 인식된 SplineMeshcomponent로 해당 구간을 반환받습니다.
Delay Changing Appearance
- Property
  - TArray<AStation*> ChangeAppearanceStations;
    - 노선 변경 구간의 양 끝 역입니다.
  - TArray<TArray> CurTunnelArea;
    - 현재 터널이 배치된 위치를 나타냅니다.
  - TArray<TArray> CurBridgeArea;
    - 현재 다리가 배치된 위치를 나타냅니다.
  - TArray NewLaneArray;
    - 새로 변경할 노선 경로를 나타냅니다.
  - int32 StartLaneArrayIndex;
    - 모양이 바뀔 구간의 시작 인덱스입니다.
  - int32 EndLaneArrayIndex;
    - 모양이 바뀔 구간의 끝 인덱스입니다.
  - bool AppearanceWillBeChanged;
    - 지연 모양 변경을 진행할지 나타냅니다.
- Function
  - void InitDelayChangeAppearanceValues();
    - 지연 모양 변경에 필요한 변수를 모두 저장하는 함수입니다.
  - bool CheckTrainsByDestinationForChangeAppearance(const TArray <class AStation*>& Stations);
    - 해당 역을 목표역으로 설정한 열차가 있는지 확인합니다.
Save & Load
- Property
  - bool HasSaveFile;
    - 세이브 파일이 있는지 나타냅니다.
- Function
  - void Save();
    - 게임 진행 중 저장해야 할 노선의 정보를 LaneSaveGame으로 저장합니다.
  - bool Load();
    - LaneSaveGame으로 저장된 파일을 불러와 Level에 불러옵니다.
  - void SpawnLaneMesh();
    - LaneMesh를 생성합니다.
  - void SetHasSaveFile(bool hasSave);
    - 세이브 파일 존재 여부를 설정합니다.
Statistics
- Function
  - void SubTotalLaneCount();
    - 총 노선의 수를 감소합니다.
  - void AddTotalModifyAndDeleteCount();
    - 노선의 수정, 삭제 횟수를 추가합니다.
  - void AddModifyAndReduceCountInEachLane();
    - 노선의 수정, 축소 횟수를 추가합니다.
  - void AddServiceStationCount(int32 Num);
    - 운행 중인 역의 개수를 추가합니다.
  - void SubServiceStationCount(int32 Num);
    - 운행 중인 역의 개수를 감소합니다.
  - float GetStationComplainAverage();
    - 역의 평균 불만도를 반환합니다.
  - void InitializeCurrentLaneStatics();
    - 현재 노선 통계를 초기화합니다.
  - void UpdateUsingConnector();
    - BridgeTunnel Item 사용 횟수를 반영합니다.

2
- Property
  - UClass* TrainClass = nullptr;
  - USplineComponent* LaneSpline;
  - USplineComponent* ReverseSpline;
3
- Property
  - TArray<UMaterial*> LaneMaterial;
  - FString LaneDefaultMaterialPath;
  - FString LanedHandleMeshPath
  - TArray<UMaterial*> RemoveLaneMaterial;
  - TArray RemoveLanePath
  - bool AlreadyDeleted = false;
  - FTimerHandle SpawnTrainCheckTimer;
  - bool IsStartHandleEditing = false;
  - bool IsEndHandleEditing = false;
4
- Function
  - void InitLaneMaterial(TArray<UMaterial*> Materials);
  - FLanePoint GetNearestLanePoint(FVector Location);
  - LaneDirection GetLaneShape(FVector Location);
  - bool GetAlreadyDeleted() const;
  - void SetAlreadyDeleted(bool _Delete);
  - void StopHandleEditing();
5
- Function
  - void CheckStationPoint();
  - void SetBendingPoint();
  - bool FindBendingPoint(FIntPoint& TargetPoint,FIntPoint PointStart, FIntPoint PointEnd);
  - void FillLanePoint();
  - void LaneCreating();
    - virtual void LaneCreating_Implementation();
  - void InitializeNewLane();
  - virtual void InitializeNewLane_Implementation();
  - void RemoveLane();
  - virtual void RemoveLane_Implementation();
  - void ExtendLane(class AStation* Station);
  - virtual void ExtendLane_Implementation(class AStation* Station);
9
- Function
  - void SetGridLaneStructure();
  - void AddAdjListDistance(AStation* First, AStation* Second);
  - FIntPoint GetWorldCoordinationByStationPointIndex(int32 Index);
10
- Property
  - TArray PointArray;
- Function
  - void SetLaneArray(const TArray<class AStation*>& NewStationPoint);
11
- Function
  - bool HasBendingPoint(FIntPoint CurrentStation, FIntPoint NextStation);
  - bool HasBendingPoint(FIntPoint Diff);
  - FIntPoint FindBendingPoint(FIntPoint CurrentStation, FIntPoint NextStation);
  - TArray GeneratePath(const FIntPoint& Start, const FIntPoint& End);
  - void AddLanePoint(const FIntPoint& Point, bool IsStation, bool IsBendingPoint, TArray& TargetArray);
  - void AddLanePoint(const FIntPoint& Point, bool IsStation, bool IsBendingPoint, TArray& TargetArray, int32 LanePosition);
12
- Property
  - TArray LaneLocation;
  - double SectionLength = 100;
  - int32 EndLoop;
- Function
  - void SetLaneLocation();
  - FVector PointToLocation(const FIntPoint& Point);
  - void ClearLanePoint();
  - void SetLaneSpline();
13
- Property
  - UMaterialInterface* MeshMaterial;
  - UMaterialInterface* RemoveMeshMaterial;
- Function
  - void SetMeshMaterial();
  - void ChangeRemoveMaterialAtIndex(int32 Index);
  - void SetSplineMeshes();
14
- Property
  - UStaticMesh* LaneMesh;
  - UStaticMesh* ThroughMesh;
  - UStaticMeshComponent* StartHandle;
  - UStaticMeshComponent* EndHandle;
- Function
  - void InitHandles();
  - void SetHandleMaterial();
  - void SetHandleTransform();
  - void SetMesh(UStaticMesh* Mesh, UStaticMesh* Through);
  - void RemoveLaneFromStart(int32 Index);
  - void ClearSplineMeshAt(int32 Index);
  - void RemoveLaneFromEnd(int32 Index, int32 ExStationNum);
  - void ExtendStart(AStation* NewStation);
  - void ExtendEnd(AStation* NewStation);
17
- Function
  - bool IsStationsValid(const TArray<class AStation*>& NewStationPoint);
  - void DisconnectBT(TArray<TArray> Area, GridType Type);
  - void ConnectBT(TArray<TArray> Area, GridType Type);
  - TArray<TArray> GetArea(const TArray& LaneBlock, GridType Type);
  - void SetArea(const TArray& Points, TArray<TArray>& AreaArray);
  - bool IsBuildble(TArray& LaneBlock);
  - TArray<TArray> GetConnectorArea(TArray& LaneBlock, GridType type);
  - int32 GetRequiredConnector(TArray<TArray>& AreaArray, GridType type);
  - ConnectorType GetConnectorType(GridType Type);
18
- Function
  - TArray GetLanePath(AStation* StartStation, AStation* EndStation);
  - TArray GetLanePathByPoint(FIntPoint StartStation, FIntPoint EndStation);
  - void GetLaneArrays(FIntPoint StartStationCoord, FIntPoint AddedStationCoord, TArray& PreLaneArray);
  - void SetMeshByIndex(int32 StartIndex, int32 LastIndex);
  - void SetSplineMeshComponent(USplineMeshComponent* SplineMeshComponent, UStaticMesh* SplineMesh, int32 Index, int32 Pos);
  - void SetSplineMeshComponent(FVector StartPos, FVector StartTangent, FVector EndPos, FVector EndTangent, int32 Index, int32 Pos);
  - FVector LineIntersection(FVector A, FVector B, FVector C, FVector D);
  - float CalculateOffset(int32 LanePosition);
  - FVector CalculateLineDirection(FVector Vector1, FVector Vector2);
  - FVector CalculatePerpendicular(FVector LineDirection, float Offset, float off);
  - FVector ChangePerpendicularToStandard(FVector Perpendicular);
  - void UpdateLocationAndSpline();
  - void GetLaneArray(const TArray<class AStation*>& NewStationPoint, TArray& PreLaneArray);
19
- Function
  - bool CheckExtendable(FIntPoint StartingStationCoordinate, FIntPoint AddedStationCoordinate);
  - void InitLaneSpline();
22
- Property
  - int32 UsingBridgeCount;
  - int32 UsingTunnelCount;

Develop Document : Lane - Tiny-Metro/Poly-Metro GitHub Wiki

노선

개요

기능

개발

생성

연장 / 축소

경로 계산(TODO)

노선 스플라인 구현(TODO)

다리/터널 아이템 개수 확인(TODO)

지연 삭제

노선 모양 변경

LaneManager

Lane 함수

⚠️ GitHub.com Fallback ⚠️

Develop Document : Lane - Tiny-Metro/Poly-Metro GitHub Wiki

노선

개요

기능

개발

생성

연장 / 축소

경로 계산(TODO)

노선 스플라인 구현(TODO)

다리/터널 아이템 개수 확인(TODO)

지연 삭제

노선 모양 변경

LaneManager

Lane 함수

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️